Netplan Migration in Logpoint¶

Netplan is a network configuration utility for Linux operating systems that uses YAML files to define configurations. Using YAML files makes it simple and intuitive to manage network interfaces, IP addresses, and other network settings.

Logpoint will start using it from v7.2.0. During v7.2.0 patch installation, a migration is performed. The migration converts the existing network configurations to YAML format and verifies whether they work as expected. If the migration is successful, users can update their network configurations using a YAML file with the netplan-apply command.

If the migration is not successful during the patch installation, use the netplan-apply command after upgrading Logpoint. The command takes a YAML file as an argument and migrates the Logpoint system to Netplan. The YAML file must contain a description of the network interfaces, IP addresses, and the paths to the network configuration backend that should be used for each device. After migration is done, you can use the netplan-apply command to update network configuration.

Network Configuration Using Netplan¶

To configure networks on Logpoint, you must first create a YAML file that details their setup. You can then apply the configuration by passing the YAML file with the netplan-apply command. The command reads the YAML file and applies the defined network configurations in Logpoint.

Example:

netplan-apply network_config.yaml

Sample YAML file:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp3s0:
      addresses:
        - 10.10.10.2/24
      nameservers:
        search: [mydomain, otherdomain]
        addresses: [10.10.10.1, 1.1.1.1]
      routes:
        - to: default
          via: 10.10.10.1

For more examples of the YAML descriptions, go to Netplan Configuration Examples.

Note

It is crucial to provide a correct YAML description. Incorrect use of the parameters can cause network disruptions or complete network outages. We recommend you plan properly before proceeding.
In the upcoming releases, Logpoint will discontinue support for network configuration that is not based on Netplan. It is recommended that you migrate your network configuration to Netplan before the next release.

Helpful?